package org.ymf.service;

import com.github.pagehelper.PageInfo;
import org.springframework.web.multipart.MultipartFile;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.util.List;
import org.ymf.entity.User;
import com.baomidou.mybatisplus.extension.service.IService;
import org.ymf.vo.UserVo;

/**
 * <p>
 * 用户 服务类
 * </p>
 *
 * @author Malphite
 * @since 2023-08-03
 */
public interface UserService extends IService<User> {

    /**
     * 分页查询用户
     * @param vo        可选条件 用户昵称(name)、 开始时间(startTime)、结束时间(endTime)、
     * @return          用户分页信息
     */
    PageInfo<User> pageUser(UserVo vo);

    /**
     * 列表查询用户
     * @param vo        可选条件 用户昵称(name)、 开始时间(startTime)、结束时间(endTime)、
     * @return          用户列表信息
     */
    List<User> listUser(UserVo vo);

    /**
     * excel导入用户
     * @param file       文件源
     * @param objects    空的 User 泛型的 arrayList
     * @param request    请求对象
     * @return           已经插入的list集合
     */
    List<User> excelUser(MultipartFile file, List<User> objects, HttpServletRequest request);

    /**
     * 添加用户基础信息
     * @param user       用户信息
     * @param request   请求对象
     * @return          成功or失败
     */
    boolean addUser(User user, HttpServletRequest request);

    /**
     * 更新用户基础信息
     * @param user       用户信息, 主键信息必填
     * @return          成功or失败
     */
    boolean updateUser(User user);

    /**
     * 删除用户基础信息
     * @param user       用户信息, 主键信息必填
     * @return          成功or失败
     */
    boolean deleteUser(User user);

    /**
     * 用户excel导出
     * @param vo  页面传入参数(name:用户昵称;startTime:开始时间;endTime:结束时间 )
     * @param response 响应对象
     * @return   无返回值，通过响应对象响应信息
     * @throws IOException  调用方法可能发生io异常等
     */
    void exportUser(UserVo vo, HttpServletResponse response) throws IOException;

    /**
     * 分页查询用户 => 根据 lasticsearch 查询信息
     * @param vo        可选条件 用户昵称(name)、 开始时间(startTime)、结束时间(endTime)、
     * @return          用户分页信息
     */
    PageInfo<User> pageUserEs(UserVo vo);

}
